home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / X11R4 / cmds / X / ddx / mfb / mfb.h < prev    next >
Encoding:
C/C++ Source or Header  |  1990-02-15  |  10.0 KB  |  334 lines
  1. /* Combined Purdue/PurduePlus patches, level 2.0, 1/17/89 */
  2. /***********************************************************
  3. Copyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts,
  4. and the Massachusetts Institute of Technology, Cambridge, Massachusetts.
  5.  
  6.                         All Rights Reserved
  7.  
  8. Permission to use, copy, modify, and distribute this software and its 
  9. documentation for any purpose and without fee is hereby granted, 
  10. provided that the above copyright notice appear in all copies and that
  11. both that copyright notice and this permission notice appear in 
  12. supporting documentation, and that the names of Digital or MIT not be
  13. used in advertising or publicity pertaining to distribution of the
  14. software without specific, written prior permission.  
  15.  
  16. DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  17. ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  18. DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  19. ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  20. WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  21. ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  22. SOFTWARE.
  23.  
  24. ******************************************************************/
  25. /* $XConsortium: mfb.h,v 5.13 89/11/13 09:46:37 rws Exp $ */
  26. /* Monochrome Frame Buffer definitions 
  27.    written by drewry, september 1986
  28. */
  29. #include "pixmap.h"
  30. #include "region.h"
  31. #include "gc.h"
  32. #include "colormap.h"
  33. #include "miscstruct.h"
  34. #include "mibstore.h"
  35.  
  36. extern int InverseAlu[];
  37.  
  38. extern Bool mfbScreenInit();
  39. extern Bool mfbCloseScreen();
  40. extern Bool mfbCreateDefColormap();
  41. extern void mfbQueryBestSize();
  42. extern Bool mfbCreateWindow();
  43. extern Bool mfbPositionWindow();
  44. extern Bool mfbChangeWindowAttributes();
  45. extern Bool mfbMapWindow();
  46. extern Bool mfbUnmapWindow();
  47. extern Bool mfbDestroyWindow();
  48.  
  49. extern Bool mfbRealizeFont();
  50. extern Bool mfbUnrealizeFont();
  51. extern Bool mfbScreenSaver();
  52. extern Bool mfbCreateGC();
  53. extern int  mfbReduceRop();
  54.  
  55. extern void mfbValidateGC(), mfbChangeGC(), mfbCopyGC();
  56. extern void mfbDestroyGC();
  57. extern void mfbChangeClip(), mfbDestroyClip(), mfbCopyClip();
  58.  
  59. extern PixmapPtr mfbCreatePixmap();
  60. extern Bool mfbDestroyPixmap();
  61.  
  62. extern void mfbCopyWindow();
  63.  
  64. extern void mfbSaveAreas();
  65. extern void mfbRestoreAreas();
  66.  
  67. /* window painter */
  68. extern void mfbPaintWindow();
  69.  
  70. /* rectangle painters */
  71. extern void mfbSolidWhiteArea();
  72. extern void mfbStippleWhiteArea();
  73. extern void mfbSolidBlackArea();
  74. extern void mfbStippleBlackArea();
  75. extern void mfbSolidInvertArea();
  76. extern void mfbStippleInvertArea();
  77. extern void mfbTileArea32();
  78.  
  79. extern void mfbPolyFillRect();
  80. extern RegionPtr mfbCopyArea();
  81. extern void mfbPolyPoint();
  82. extern RegionPtr mfbCopyPlane();
  83. extern void mfbPolyFillArcSolid();
  84.  
  85. extern void mfbSetSpans();
  86. extern void mfbGetSpans();
  87. extern void mfbWhiteSolidFS();
  88. extern void mfbBlackSolidFS();
  89. extern void mfbInvertSolidFS();
  90. extern void mfbWhiteStippleFS();
  91. extern void mfbBlackStippleFS();
  92. extern void mfbInvertStippleFS();
  93. extern void mfbTileFS();
  94. extern void mfbUnnaturalTileFS();
  95. extern void mfbUnnaturalStippleFS();
  96.  
  97. extern void mfbGetImage();
  98. extern void mfbPutImage();
  99.  
  100. extern void mfbLineSS();    /* solid single-pixel wide line */
  101.                 /* calls mfb{Bres|Horz|Vert}S() */
  102. extern void mfbLineSD();
  103. extern void mfbSegmentSS();
  104. extern void mfbSegmentSD();
  105. extern void mfbZeroPolyArcSS();
  106. extern void mfbImageText8();
  107. extern void mfbImageText16();
  108. extern int mfbPolyText16();
  109. extern int mfbPolyText8();
  110. extern PixmapPtr mfbCopyPixmap();
  111. extern RegionPtr mfbPixmapToRegion();
  112. extern void mfbSolidPP();
  113. extern void mfbPushPixels();
  114.  
  115. /* text for glyphs <= 32 bits wide */
  116. extern void mfbImageGlyphBltWhite();
  117. extern void mfbImageGlyphBltBlack();
  118. extern void mfbPolyGlyphBltWhite();
  119. extern void mfbPolyGlyphBltBlack();
  120. extern void mfbPolyGlyphBltInvert();
  121.  
  122. /* text for terminal emulator fonts */
  123. extern void mfbTEGlyphBltWhite();    /* fg = 1, bg = 0 */
  124. extern void mfbTEGlyphBltBlack();    /* fg = 0, bg = 1 */
  125.  
  126. extern int mfbListInstalledColormaps();
  127. extern void mfbInstallColormap();
  128. extern void mfbUninstallColormap();
  129. extern Bool mfbCreateColormap();
  130. extern void mfbDestroyColormap();
  131. extern void mfbResolveColor();
  132.  
  133. extern void mfbCopyGCDest();
  134.  
  135. extern void mfbCopyRotatePixmap();
  136. extern void mfbYRotatePixmap();
  137. extern void mfbXRotatePixmap();
  138. extern void mfbPadPixmap();
  139.  
  140. /*
  141.    private filed of pixmap
  142.    pixmap.devPrivate = (unsigned int *)pointer_to_bits
  143.    pixmap.devKind = width_of_pixmap_in_bytes
  144.  
  145.    private field of screen
  146.    a pixmap, for which we allocate storage.  devPrivate is a pointer to
  147. the bits in the hardware framebuffer.  note that devKind can be poked to
  148. make the code work for framebuffers that are wider than their
  149. displayable screen (e.g. the early vsII, which displayed 960 pixels
  150. across, but was 1024 in the hardware.)
  151.  
  152.    private field of GC 
  153.     Freeing pCompositeClip is done based on the value of
  154. freeCompClip; if freeCompClip is not carefully maintained, we will end
  155. up losing storage or freeing something that isn't ours.
  156. */
  157.  
  158. typedef struct {
  159.     unsigned char    rop;        /* reduction of rasterop to 1 of 3 */
  160.     unsigned char    ropOpStip;    /* rop for opaque stipple */
  161.     unsigned char    ropFillArea;    /*  == alu, rop, or ropOpStip */
  162.     unsigned    fExpose:1;        /* callexposure handling ? */
  163.     unsigned    freeCompClip:1;
  164.     PixmapPtr    pRotatedPixmap;        /* tile/stipple rotated to align */
  165.     RegionPtr    pCompositeClip;        /* free this based on freeCompClip
  166.                        flag rather than NULLness */
  167.     void     (* FillArea)();        /* fills regions; look at the code */
  168.     } mfbPrivGC;
  169. typedef mfbPrivGC    *mfbPrivGCPtr;
  170.  
  171. extern int  mfbGCPrivateIndex;        /* index into GC private array */
  172. extern int  mfbWindowPrivateIndex;    /* index into Window private array */
  173.  
  174. /* private field of window */
  175. typedef struct {
  176.     unsigned char fastBorder;    /* non-zero if border tile is 32 bits wide */
  177.     unsigned char fastBackground;
  178.     unsigned short unused; /* pad for alignment with Sun compiler */
  179.     DDXPointRec    oldRotate;
  180.     PixmapPtr    pRotatedBackground;
  181.     PixmapPtr    pRotatedBorder;
  182.     } mfbPrivWin;
  183.  
  184. /* precomputed information about each glyph for GlyphBlt code.
  185.    this saves recalculating the per glyph information for each
  186. box.
  187. */
  188. typedef struct _pos{
  189.     int xpos;        /* xposition of glyph's origin */
  190.     int xchar;        /* x position mod 32 */
  191.     int leftEdge;
  192.     int rightEdge;
  193.     int topEdge;
  194.     int bottomEdge;
  195.     unsigned int *pdstBase;    /* longword with character origin */
  196.     int widthGlyph;    /* width in bytes of this glyph */
  197. } TEXTPOS;
  198.  
  199. /* reduced raster ops for mfb */
  200. #define RROP_BLACK    GXclear
  201. #define RROP_WHITE    GXset
  202. #define RROP_NOP    GXnoop
  203. #define RROP_INVERT    GXinvert
  204.  
  205. /* out of clip region codes */
  206. #define OUT_LEFT 0x08
  207. #define OUT_RIGHT 0x04
  208. #define OUT_ABOVE 0x02
  209. #define OUT_BELOW 0x01
  210.  
  211. /* major axis for bresenham's line */
  212. #define X_AXIS    0
  213. #define Y_AXIS    1
  214.  
  215. /* optimization codes for FONT's devPrivate field */
  216. #define FT_VARPITCH    0
  217. #define FT_SMALLPITCH    1
  218. #define FT_FIXPITCH    2
  219.  
  220. /* macros for mfbbitblt.c, mfbfillsp.c
  221.    these let the code do one switch on the rop per call, rather
  222. than a switch on the rop per item (span or rectangle.)
  223. */
  224.  
  225. #define fnCLEAR(src, dst)    (0)
  226. #define fnAND(src, dst)     (src & dst)
  227. #define fnANDREVERSE(src, dst)    (src & ~dst)
  228. #define fnCOPY(src, dst)    (src)
  229. #define fnANDINVERTED(src, dst)    (~src & dst)
  230. #define fnNOOP(src, dst)    (dst)
  231. #define fnXOR(src, dst)        (src ^ dst)
  232. #define fnOR(src, dst)        (src | dst)
  233. #define fnNOR(src, dst)        (~(src | dst))
  234. #define fnEQUIV(src, dst)    (~src ^ dst)
  235. #define fnINVERT(src, dst)    (~dst)
  236. #define fnORREVERSE(src, dst)    (src | ~dst)
  237. #define fnCOPYINVERTED(src, dst)(~src)
  238. #define fnORINVERTED(src, dst)    (~src | dst)
  239. #define fnNAND(src, dst)    (~(src & dst))
  240. #define fnSET(src, dst)        (~0)
  241.  
  242. /*  Using a "switch" statement is much faster in most cases
  243.  *  since the compiler can do a look-up table or multi-way branch
  244.  *  instruction, depending on the architecture.  The result on
  245.  *  A Sun 3/50 is at least 2.5 times faster, assuming a uniform
  246.  *  distribution of RasterOp operation types.
  247.  *
  248.  *  However, doing some profiling on a running system reveals
  249.  *  GXcopy is the operation over 99.5% of the time and
  250.  *  GXcopy is the next most frequent (about .4%), so we make special
  251.  *  checks for those first.
  252.  *
  253.  *  Note that this requires a change to the "calling sequence"
  254.  *  since we can't engineer a "switch" statement to have an lvalue.
  255.  */
  256. #define DoRop(result, alu, src, dst) \
  257. { \
  258.     if (alu == GXcopy) \
  259.     result = fnCOPY (src, dst); \
  260.     else if (alu == GXxor) \
  261.         result = fnXOR (src, dst); \
  262.     else \
  263.     switch (alu) \
  264.     { \
  265.       case GXclear: \
  266.         result = fnCLEAR (src, dst); \
  267.         break; \
  268.       case GXand: \
  269.         result = fnAND (src, dst); \
  270.         break; \
  271.       case GXandReverse: \
  272.         result = fnANDREVERSE (src, dst); \
  273.         break; \
  274.       case GXandInverted: \
  275.         result = fnANDINVERTED (src, dst); \
  276.         break; \
  277.       case GXnoop: \
  278.         result = fnNOOP (src, dst); \
  279.         break; \
  280.       case GXor: \
  281.         result = fnOR (src, dst); \
  282.         break; \
  283.       case GXnor: \
  284.         result = fnNOR (src, dst); \
  285.         break; \
  286.       case GXequiv: \
  287.         result = fnEQUIV (src, dst); \
  288.         break; \
  289.       case GXinvert: \
  290.         result = fnINVERT (src, dst); \
  291.         break; \
  292.       case GXorReverse: \
  293.         result = fnORREVERSE (src, dst); \
  294.         break; \
  295.       case GXcopyInverted: \
  296.         result = fnCOPYINVERTED (src, dst); \
  297.         break; \
  298.       case GXorInverted: \
  299.         result = fnORINVERTED (src, dst); \
  300.         break; \
  301.       case GXnand: \
  302.         result = fnNAND (src, dst); \
  303.         break; \
  304.       case GXset: \
  305.         result = fnSET (src, dst); \
  306.         break; \
  307.     } \
  308. }
  309.  
  310.  
  311. #define DoRRop(alu, src, dst) \
  312. (((alu) == RROP_BLACK) ? ((dst) & ~(src)) : \
  313.  ((alu) == RROP_WHITE) ? ((dst) | (src)) : \
  314.  ((alu) == RROP_INVERT) ? ((dst) ^ (src)) : \
  315.   (dst))
  316.  
  317. /* A generalized form of a x4 Duff's Device */
  318. #define Duff(counter, block) { \
  319.   while (counter >= 4) {\
  320.      { block; } \
  321.      { block; } \
  322.      { block; } \
  323.      { block; } \
  324.      counter -= 4; \
  325.   } \
  326.      switch (counter & 3) { \
  327.      case 3:    { block; } \
  328.      case 2:    { block; } \
  329.      case 1:    { block; } \
  330.      case 0: \
  331.      counter = 0; \
  332.    } \
  333. }
  334.